home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / comm / news / DWdecode14.readme < prev    next >
Text File  |  1997-09-05  |  8KB  |  203 lines
  1. Short:    (v1.04) SMART mass decoder of USENET binaries
  2. Author:   dwhiting@europa.com  (Dick Whiting)
  3. Uploader: dwhiting@europa.com  (Dick Whiting)
  4. Version:  V1.04 Minor fix
  5. Type:     comm/news
  6. Replaces: comm/news/DWdecode*
  7.  
  8.  
  9. REQUIREMENTS: 
  10. -------------
  11.  
  12. You will need several programs/libraries from Aminet:
  13.  
  14.    RexxArpLib by Willy Langeveld  - util/rexx/ral3p3.lha
  15.  
  16.    FlashFind  by Frank Würkner    - util/cli/FlashFind1.2.lha
  17.  
  18.    A UUdecoder
  19.      e.g. UUout by Nicolas Dade   - util/arc/uuOut114.lha
  20.      
  21.    A Base64 decoder 
  22.      e.g. Base64coders by Edmund Vermeulen - comm/mail/Base64coders.lha
  23.  
  24.    A BinHex decoder 
  25.      e.g. binhex374 by Nik Soggia - util/arc/binhex374.lha
  26.  
  27.    And, of course, some Use Net files with encoded binaries;)
  28.  
  29. FILES INCLUDED IN THIS ARCHIVE:
  30.  
  31.    DWdecode               - the REAL program.
  32.    DWdecode.Base64.Types  - means of identifying Base64 first lines
  33.    DWdecode.Binary.Types  - means of identifying filenames in subject
  34.    DWdecode.Doc           - text format of documentation
  35.    DWdecode.Encode.Types  - MIME encoding types
  36.    DWdecode.Guide         - Amiga guide documentation
  37.    DWdecode.Guide.info    - info file for guide
  38.    DWdecode.Prefs         - a starter preference file
  39.    DWdecode.Readme        - copy of the Aminet readme file
  40.    DWdecode.Section.Types - describes Section lines of UUencoded files
  41.    DWdecode.Skip.Froms    - allows for filtering based on From: lines
  42.    DWdecode.Skip.Subjects - allows for filtering based on Subject: lines 
  43.    Samples/....           - subdirectory with example script(s)
  44.  
  45.    arexxqsort.lha         - handles sorting of stem variables.
  46.        by Willy Langeveld - originally found on Aminet 
  47.  
  48.  
  49. BASICS: 
  50. -------
  51.  
  52. This program does MASS decoding of Use Net files. It decodes ALL binaries
  53. that it is able to recognize, which is most;) from the source directory
  54. and optionally from ALL subdirectories as well.
  55.  
  56.  
  57. WHAT IT DOES:
  58. -------------
  59.  
  60. It uses information from MIME content lines, section lines, begin lines
  61. and (if it must) the subject line to determine what kind of encoding is
  62. used and which parts go together. It reports on files that have missing
  63. parts and on ones that it is unable to obtain complete information for.   
  64.  
  65. It handles either single directories or can handle COMPLETE directory trees.
  66.  
  67. It handles files with SINGLE & MULTIPLE UUencoded OR Base64 binaries 
  68. within them and Multipart UUencoded or Base64 files.
  69.  
  70. It handles files with APPLE/DOUBLE format. My logic uses the LAST file 
  71. of a given name within a SINGLE input file. This forces the APPLE portion
  72. to be considered a duplicate and not processed.
  73.  
  74. It allows you to filenote the decoded binaries with a variety of
  75. substitution values as well as literals. 
  76.  
  77. It is quite 'smart' and generally can figure out most files.
  78.  
  79. It is highly configurable and using external files can 'learn'.
  80.  
  81. It should work with almost ANY Base64 and UU decoder.
  82. See WARNING below about pathname removal.
  83.  
  84. It allows for filtering based on From: and/or Subject: lines.
  85.  
  86. It allows for deleting input files after decoding, deleting duplicates, 
  87. deleting input files based on From: &/or Subject: lines, deleting files
  88. that have ONLY text in them, and deleting files based on their age.    
  89.  
  90. Reporting can be tailored by setting/unsetting a variety of switches on the
  91. command line or in the prefs file.
  92.  
  93. ------------------------------------------------------------------
  94.  
  95.   v1.04 Fixes:
  96.  
  97.       Bug fix for errors introduced in handling files with spaces in
  98.       their names.
  99.  
  100.   v1.03 Changes:      
  101.  
  102.       Changed to handle input files with spaces in their names.        
  103.  
  104.       Added XMAIL option. Set this to YES to prevent filenoting input files. 
  105.       It also overrides the DELETETEXT option. 
  106.       This is useful for handling YAM (© Marcel Beck) directories, which use
  107.       the file comment area.
  108.  
  109.       Fixed to handle Date: headers with EST style GMT offsets. 
  110.       Found some mail Date: headers have TABS in them. Fixed.
  111.       This should allow for running against mail directories properly.
  112.  
  113.  
  114.   v1.02 Fixes:        
  115.  
  116.       Finally, I HOPE, have fixed adding libraries during init. Several
  117.       people told me I hadn't... must have been some other program;)
  118.  
  119.   v1.01 Fixes/Changes:        
  120.  
  121.       Discovered that RexxTricks.Library uses the SAME function name as 
  122.          QuickSort, BUT in a different format. 
  123.          Added code to test if RexxTricks is present and to call QSORT 
  124.          in that format if necessary instead of W.L's. 
  125.          The SORTS are faster if RexxTricks.Library is NOT present,
  126.          so try to do decoding prior to anything that might add it.
  127.  
  128.       Can NOW place in directory named DWDECODE and have it WORK!! Really 
  129.          stupid error - thanks to Paul Copsey for finding this one.
  130.  
  131.       Now correctly deletes parts greater than 1 of multipart input files
  132.          when DeleteDups is specified. 
  133.  
  134.       If DWdecode MUST resort to using just Subject: line information will
  135.          now consider the SAME partname appearing multiple times in the 
  136.          subject, IFF it is the only name present, as THE name to use.
  137.  
  138.       Added support for BinHex files (only 1/1 type files). 
  139.          New variables w/defaults: 
  140.             BinHexCmd='BHD data=%DF %SF'
  141.             BinCmdFail=20
  142.  
  143.       Removed unused variable DumpB64Files from preferences/help.
  144.  
  145.       Now handles PC type lines with Ctrl-M's
  146.  
  147.       Now filenotes output files containing parens in their names
  148.  
  149.       Now writes FileNote errors to log/console as requested
  150.  
  151.       Made maximum filename length on report = 30 characters.          
  152.  
  153.       Added message referring user to logfile for errors.
  154.  
  155.       Added Guide format of 'documentation'.
  156.  
  157.  
  158.   v1.0  Initial Release
  159.  
  160. ------------------------------------------------------------------
  161.  
  162. I homeschool my kids and they would love a postcard from where EVER you live. 
  163. Instant Geography Lesson;)      
  164.                                                                           
  165. POSTCARDS:    Dick Whiting                                                
  166.               28590 S. Beavercreek Rd.                                    
  167.               Mulino, Oregon 97042                                        
  168.               USA                                                         
  169.                                                                           
  170. Bug Reports, etc:                                                         
  171.                                                                           
  172. Dick Whiting <dwhiting@europa.com>                   
  173. August 04, 1997
  174.                                                                         
  175. ------------------------------------------------------------------
  176.  
  177.  
  178. ============================= Archive contents =============================
  179.  
  180. Original  Packed Ratio    Date     Time    Name
  181. -------- ------- ----- --------- --------  -------------
  182.     8234    8234  0.0% 01-Jan-97 18:13:20 +arexxqsort.lha
  183.   168348   31578 81.2% 13-Jul-97 18:51:56 +DWdecode
  184.     1776     260 85.3% 31-Dec-96 15:46:06 +DWdecode.Base64.Types
  185.     2845     623 78.1% 19-Jul-97 18:10:34 +DWdecode.Binary.Types
  186.      478     236 50.6% 25-Feb-97 21:36:32 +DWdecode.guide.info
  187.     5850    1345 77.0% 08-Jan-97 01:05:08 +DWdecode.Section.Types
  188.     2816     587 79.1% 31-Dec-96 15:55:10 +DWdecode.Encode.Types
  189.    56761   13718 75.8% 05-Aug-97 20:57:52 +DWdecode.guide
  190.     3880     757 80.4% 28-Mar-97 23:22:10 +DWdecode.Prefs
  191.     6712    2741 59.1% 05-Aug-97 21:01:02 +DWdecode.ReadMe
  192.     1944     405 79.1% 02-Jan-97 17:01:02 +DWdecode.Skip.Froms
  193.     2916     537 81.5% 02-Jan-97 17:03:32 +DWdecode.Skip.Subjects
  194.      628     255 59.3% 19-Jul-97 18:20:24  DWdecode1.04.info
  195.    54191   13089 75.8% 05-Aug-97 20:55:28 +DWdecode.Doc
  196.        0       0  0.0% 02-Jan-97 17:37:34 +DWdecode.Trap.Encodes
  197.        0       0  0.0% 02-Jan-97 17:04:32 +DWdecode.Trap.Sections
  198.      628     251 60.0% 02-Jan-97 16:56:26 +SAMPLES.info
  199.      828     313 62.1% 02-Jan-97 16:59:18 +DoArts
  200.     1778     751 57.7% 04-Jan-97 00:52:24 +fixfilenotes
  201. -------- ------- ----- --------- --------
  202.   320613   75680 76.3% 07-Aug-97 08:34:38   19 files
  203.